Trac is being migrated to new services! Issues can be found in our new YouTrack instance and WIKI pages can be found on our website.

Changes between Version 136 and Version 137 of Using Pidgin


Ignore:
Timestamp:
Aug 28, 2008, 12:33:04 AM (15 years ago)
Author:
chemistrydioxide
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Using Pidgin

    v136 v137  
    33[[TOC(inline,noheading)]]
    44
    5 == All Platforms ==
    6 
    7 === Getting Started ===
    8 
    9 ==== How do I use AIM, MSN, Yahoo!, Google Talk/Jabber/XMPP, ICQ, or any other protocol? ====
     5== Getting Started ==
     6
     7=== How do I use AIM, MSN, Yahoo!, Google Talk/Jabber/XMPP, ICQ, or any other protocol? ===
    108Use the Account Editor (Accounts->Add/Edit) to add the account of the appropriate messaging service.  Use the checkbox in the account editor to enable the current account.
    119
    1210For Google Talk, fill in the Domain field with the domain of your Google Mail e-mail address.  For most users this will be gmail.com or googlemail.com, but Google Apps for Your Domain users will use their domain instead.
    1311
    14 ==== How do I register for a new account? ====
     12=== How do I register for a new account? ===
    1513This depends on the protocol.
    1614 * '''AIM:''' Go to [https://reg.my.screenname.aol.com/_cqr/registration/initRegistration.psp?mcState=initialized&seamless=n&createSn=1&sitedomain=www.aim.com&siteState=http://www.aim.com/get_aim/congratsd2.adp this website].
     
    2321 * '''Novell:''' See your Novell server administrator.
    2422
    25 === Buddy Icons (Avatars), Buddy List and Blocking ===
    26 
    27 ==== How do I set a buddy icon or avatar? ====
     23== Buddy Icons (Avatars), Buddy List and Blocking ==
     24
     25=== How do I set a buddy icon or avatar? ===
    2826We call all user pictures, avatars, etc. buddy icons.  There are two ways to set one for yourself:
    2927  * '''Global''' - This will affect all of your accounts.  On the Buddy List window, beside the status selector at the bottom, there is an area that will have a generic photo icon if you have no icon set.  You can click that and select an icon from there.  The icon will take effect for all accounts you have configured in Pidgin.
     
    4240Pidgin itself (for the chat window) will scale icons up or down to 32x32 for display in the buddy list and the infopane.  In general, to maintain the aspect ratio, you should begin with a square icon.
    4341
    44 ==== A friend of mine uses my favorite episode of ''The Young and the Restless'' as her buddy icon, but I can't quite make it out in the infopane.  What do I do? ====
     42=== A friend of mine uses my favorite episode of ''The Young and the Restless'' as her buddy icon, but I can't quite make it out in the infopane.  What do I do? ===
    4543
    4644The easiest thing to do is ask your friend to put it up on !YouTube or some equivalent service.  Alternatively, you could buy it on DVD, if available.  The mouse-over tooltip on the infopane also has her full-size buddy icon, for a quick fix.  Additionally, clicking the icon in the infopane should also enlarge it.
    4745
    48 ==== How can I unblock someone? ====
     46=== How can I unblock someone? ===
    4947See the "Privacy" option under the "Tools" menu in the Buddy List.
    5048
    51 ==== Why are the status icons so big? ====
    52 ==== Can I make buddy list entries smaller? ====
     49=== Why are the status icons so big? ===
     50=== Can I make buddy list entries smaller? ===
    5351We believe that, by adding a second line of text to each buddy list entry, we're able to show more information about each buddy on the buddy list.  The "Big List," as we call it, shows status text and idle time concisely and attractively.  Most importantly, it puts the buddy icon in the list, making it far easier to locate buddies within a large list where names are harder to pick out than images.  Due to the increased usability of this interface, we have made it the default.
    5452
    5553We are aware that some people feel more comfortable using an interface more similar to IM clients they may have used in the past.  The 'Big List' can  be disabled by un-checking "Show buddy details" in the Buddies menu.
    5654
    57 ==== Can I import or export my buddy list? ====
     55=== Can I import or export my buddy list? ===
    5856Not with Pidgin alone, but the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] provides the [http://plugins.guifications.org/trac/wiki/listhandler List Handler] plugin, which adds some importing and exporting capabilities.
    5957
    60 ==== Why are my logs combining the logs of several of my buddies? ====
     58=== Why are my logs combining the logs of several of my buddies? ===
    6159It's likely you have inadvertently combined some buddies into contacts when you did not intend to do so.  To correct this you need to find which contact the logs are associated with.  Right-click that entry in the buddy list and click Expand.  Drag out the buddies that do not belong in the contact.
    6260
    63 ==== Where did my buddy go?  I just tried to change its group and it disappeared! ====
     61=== Where did my buddy go?  I just tried to change its group and it disappeared! ===
    6462You inadvertently created a contact from two buddies.  Hover over each buddy in the destination group and watch the tooltips that appear.  You'll see the "missing" buddy in one of them.  Right-click that entry in the buddy list, click Expand, and then drag the buddy that does not belong out to the group.  Watch the buddy list carefully; a bar will appear to show you where the buddy will go if you are in the right location.
    6563
    66 ==== Can I group buddies by their owner, like Trillian's or Miranda's Metacontacts? ====
     64=== Can I group buddies by their owner, like Trillian's or Miranda's Metacontacts? ===
    6765Sure! Right click a buddy on your list and at the bottom of the menu click "Expand".  Then just drag other screen names to the same person below it.  When you're done, click on the arrow to collapse them.  When the contact is collapsed, Pidgin will select a buddy to display based on the status of the buddies in the contact, and their order.
    6866
    6967If you use the Alias function, by either highlighting a buddy and pressing F2 or right-clicking and selecting "Alias...," when two or more buddies in the same group are aliased to the same name, Pidgin will prompt you to automatically merge them together into one contact.
    7068
    71 ==== I grouped my buddies into contacts, can I control which one is selected? ====
     69=== I grouped my buddies into contacts, can I control which one is selected? ===
    7270Yes and no.  Pidgin uses an algorithm to determine which buddy is selected.  If you right click on a contact
    7371and select expand, you can see an ordered list of the buddies in that contact.  Pidgin will pick the                                                                                                                                                 highest/topmost buddy that is most available.
     
    8280With this search pattern, you should be able to drag the buddies in that contact into an order that will yield reasonable results for that contact most of the time.  While this will be sufficient for most people most of the time, we recognize that a small minority of users may need to control things more precisely.  In the source tarball there is a plugin, contact_priority, that does not install by default.  If installed and loaded, this plugin allows for some modifications to the algorithm that Pidgin uses.  Specifically, you can weight certain accounts to be either more likely to be chosen or less likely to be chosen. This cannot, however, be done on a per-buddy basis with the existing plugin.
    8381
    84 ==== Why are protocol icons not displayed in the buddy list and conversation windows any more? ====
     82=== Why are protocol icons not displayed in the buddy list and conversation windows any more? ===
    8583See [http://pidgin.im/~seanegan/blog/identity.html Sean's blog entry on the subject] for the rationale behind this change.  However, as of Pidgin 2.2.0 you can add protocol icons to the buddy list with Buddies-> Show->Protocol Icons.  The [http://plugins.guifications.org/trac/wiki/convbadger convbadger plugin] from the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] adds protocol icons to conversation windows.
    8684
    87 ==== How do I remove a buddy from my buddy list? ====
     85=== How do I remove a buddy from my buddy list? ===
    8886Right-click the buddy and click Remove.
    8987
    90 === Keyboard Shortcuts ===
    91 
    92 ==== What are the default keyboard shortcuts (key bindings)? ====
     88== Keyboard Shortcuts ==
     89
     90=== What are the default keyboard shortcuts (key bindings)? ===
    9391See [wiki:shortcuts this wiki page] for a list.
    9492
    95 ==== How do I make Enter make a newline and Ctrl+Enter send? ====
     93=== How do I make Enter make a newline and Ctrl+Enter send? ===
    9694
    9795Locate or create your `gtkrc-2.0` file and insert:
     
    105103}}}
    106104
    107 ==== How do I make Pidgin use emacs-like keybindings? ====
     105=== How do I make Pidgin use emacs-like keybindings? ===
    108106Locate or create your `.gtkrc-2.0` file and insert the following:
    109107{{{
     
    112110You will need to restart Pidgin when you have finished.  Note that this will affect other GTK+ applications as well.
    113111
    114 ==== How do I bind keystrokes to menu items? ====
     112=== How do I bind keystrokes to menu items? ===
    115113
    116114Locate or create your `gtkrc-2.0` file and insert:
     
    124122If you're using a recent enough Gnome, you can instead open the ''Appearance'' preferences applet, switch to the ''Interface'' tab and toggle ''Editable menu shortcut keys''.  In older versions of Gnome, use `gconf-editor` to set the `/desktop/gnome/interface/can_change_accels` key instead (which is what happens in newer Gnomes behind the scenes anyway).  You don't need to restart Pidgin if you take the gconf path.
    125123
    126 ==== How do I make Escape close conversation windows? ====
     124=== How do I make Escape close conversation windows? ===
    127125As of 2.4.2 this option is included by default. The option is under Tools ⇒ Preferences ⇒ Interface Tab.
    128126
    129 === Spell Checking ===
    130 
    131 ==== How do I change the language for the Highlight Misspelled words option? ====
     127== Spell Checking ==
     128
     129=== How do I change the language for the Highlight Misspelled words option? ===
    132130Pidgin currently only supports spell checking in your locale language.  This is because gtkspell 2 does not offer a good way for us to know which dictionaries are available or to switch between them.  This functionality has long been promised for gtkspell version 3, which has been delayed somewhat indefinitely.  See [http://gtkspell.sf.net gtkspell.sf.net].
    133131
    134132There is, however a simple plugin called [http://plugins.guifications.org/trac/wiki/switchspell switchspell] that can change the spell check language on a per-buddy basis.
    135133
    136 ==== Why do all words I type get highlighted as misspelled? ====
     134=== Why do all words I type get highlighted as misspelled? ===
    137135We've seen several users with this issue.  It seems to be that the dictionary for the spell checking language is missing.  Most likely you need to install a package named "`aspell-XX`" where `XX` is the language you run Pidgin in, such as `en` for English or `es` for Spanish.
    138136
    139 === Statuses ===
    140 
    141 ==== How does Pidgin decide which saved statuses to show in the status selector? ====
     137== Statuses ==
     138
     139=== How does Pidgin decide which saved statuses to show in the status selector? ===
    142140Pidgin shows six "popular" saved statuses in the status selector. These are your six most recently used statuses, offset by a weight. Pidgin sorts all your saved statuses by the timestamp when they were last used.  And then, for each time you've used a status, the timestamp is increased by one day.
    143141
    144142If you are upgrading from 1.x or lower, Pidgin is unable to determine which are the most popular states, as these older releases did not save that information.  As a result, the initial contents of the menu will be somewhat random.  It will settle over the first few uses of (distinct) states into the behavior described above.
    145143
    146 ==== Why are no states listed when I go to set a state for Auto Away? ====
     144=== Why are no states listed when I go to set a state for Auto Away? ===
    147145Pidgin can only use saved states for Auto Away.  You need to create and save a named state first.
    148146
    149 === Smileys (Emoticons) ===
    150 
    151 ==== Does Pidgin support animated smileys? ====
     147== Smileys (Emoticons) ==
     148
     149=== Does Pidgin support animated smileys? ===
    152150Yes, but there is a bug which can cause animation to be lost if Pidgin has to resize the image.  Also, only the most recent 20 emoticons are animated.
    153151
    154 ==== How do I use/make smiley themes? ====
     152=== How do I use/make smiley themes? ===
    155153See [wiki:SmileyThemes the page on smileys].
    156154
    157 ==== Can I save custom emoticons as animated gif? ====
     155=== Can I save custom emoticons as animated gif? ===
    158156No, you can't. Gdk doesn't allow us to save animated gif. We are looking for something to workaround this issue.
    159157
    160 === Look & Feel ===
    161 
    162 ==== Can I "skin" Pidgin? ====
     158=== Why did my smiley theme disappear after I upgraded Pidgin? ===
     159Smiley themes should be installed to the user's .purple directory, not in the location Pidgin is installed to.  This means that you install smiley themes only to `%APPDATA%\.purple\smileys` (if you're using Windows) or `~/.purple/smileys` (if you're using Linux/*nix).  Additions to or removals from Pidgin's installation location will be lost during an upgrade.
     160
     161== Look & Feel (All platforms) ==
     162
     163=== Can I "skin" Pidgin? ===
    163164The UI can be customized using GTK themes and by [wiki:SmileyThemes Smiley Themes].  Application-specific skins will never be supported by Pidgin.  This seems to confuse a lot of users, so here's an attempt at an explanation.
    164165
     
    177178The default location on Windows to add the theme is: `C:\Program Files\Common Files\GTK\2.0\share\themes` (TODO: This isn't correct, it should be the user-specific directory, not the global directory).
    178179
    179 ==== How do I change the font Pidgin uses?  The background color? ====
     180=== How do I change the font Pidgin uses?  The background color? ===
    180181The font preference in Pidgin applies only for the formatting of outgoing messages on those protocols which support said formatting.  The display fonts used by the rest of Pidgin are those specified by GTK+, the toolkit we use to create the user interface.  If you're using Gnome, you can change these in System ⇒ Preferences ⇒ Appearance ⇒ Fonts; the font used for conversations is the ''document'' font, while the rest of Pidgin uses the ''application'' font.
    181182
     
    231232You could also switch GTK+ themes.  Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
    232233
    233 === Crashes and Bugs ===
    234 
    235 ==== What should I do if Pidgin crashes? ====
     234== Look & Feel (Windows) ==
     235
     236=== How do I change the look and feel? ===
     237See [#CanIskinPidgin this FAQ entry].
     238
     239=== What is a gtkrc file and where can I find it? ===
     240The windowing toolkit that Pidgin uses, GTK+, is configurable via a text file.
     241
     242There is a global file found in the `etc\gtk-2.0` directory your GTK+ Runtime install directory (`C:\Program Files\Common Files\GTK\2.0`, by default).
     243There is also per-user file (named `.gtkrc-2.0`) in your user's home directory, the location of this varies according to the version of Windows you're using and the configuration.
     244 * For Windows 2000/XP/Vista(?), entering `%USERPROFILE%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username`).
     245 * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`.
     246 * If you have the `HOME` environment variable set, it will override the default per-user file location.
     247
     248**Note that Windows Explorer will not allow you create a file that starts with a period; you'll need to use a text editor or rename the file in a cmd shell.
     249
     250There is also a pidgin-specific file that is located in the configuration directory (`%APPDATA%\.purple\gtkrc-2.0`).
     251
     252It is recommended that you edit your per-user file or the pidgin-specific file instead of the global file as the global file will be replaced when GTK+ is upgraded.
     253
     254=== Can I make Pidgin transparent/translucent? ===
     255You can make Pidgin translucent in most versions of Windows using the "Transparency" plugin that ships with Pidgin for Windows.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can to make any window translucent.
     256
     257=== Can I make Pidgin or its instant message windows always stay on top? ===
     258If you just want the buddy list to always be on top, you can dock it to the side of your desktop.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can set any window to be 'Always On Top'.
     259
     260== Look & Feel (Linux and Unix-like platforms) ==
     261
     262=== How do I change the look and feel? ===
     263See [#CanIskinPidgin this FAQ entry].
     264
     265Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
     266
     267The system-wide location on Windows to add themes is `C:\Program Files\Common Files\GTK\2.0\share\themes`, but this location will be overwritten when installing updated GTK+ runtime versions.
     268
     269=== Can I make Pidgin transparent/translucent? ===
     270It is not yet possible to make Pidgin translucent in Linux and other platforms that use X11.
     271
     272The X.org X11 server provides a COMPOSITE extension that allows applications to have true translucency, but it is X.org-specific and it requires support at the GTK+ level (if it is to be per-widget).  Support for this is apparently scheduled for inclusion GDK 2.12, but we are not currently interested in implementing support for it (note that a plugin could provide this functionality).  Pseudo-translucency offered by other programs (by copying a section of your background image, tinting it, and plastering it onto a window) will never be implemented in Pidgin.
     273
     274Note that if you are using a compisiting window manager such as Compiz, you may have global support for modifying the opacity of any window.  For example, in Compiz, the default method to changing the opacity of a window is Alt+Mouse Scroll Wheel.  This method does not require extra support from the applications.
     275
     276== Crashes and Bugs ==
     277
     278=== What should I do if Pidgin crashes? ===
    236279Follow the instructions [wiki:TipsForBugReports#WhattodoifPidgincrashes here] to submit a bug report.
    237280
    238 ==== Why does Pidgin crash when I start it? ====
     281=== Why does Pidgin crash when I start it? ===
    239282Here are some things to try:
    240283  * Make sure you are running the most recent version of Pidgin.
     
    247290  * If none of these help, read TipsForBugReports.
    248291
    249 ==== Pidgin <non-current-version> is buggy.  Why? ====
    250 ==== Pidgin from Monotone is buggy.  Why? ====
     292=== Pidgin <non-current-version> is buggy.  Why? ===
     293=== Pidgin from Monotone is buggy.  Why? ===
    251294Non-current versions have old bugs which may be fixed in the current version--that's why we make new releases.  Monotone is frequently unusable because of changes in the code.  Bugs are introduced during the development process and are hopefully fixed before a release is made.
    252295
    253 === Voice and Video (Microphone and Webcam) Support (Not Implemented Yet) ===
    254 
    255 ==== Does Pidgin support webcams (video)? ====
    256 ==== Does Pidgin support MSN video chat? ====
     296== Voice and Video (Microphone and Webcam) Support (Not Implemented Yet) ==
     297
     298=== Does Pidgin support webcams (video)? ===
     299=== Does Pidgin support MSN video chat? ===
    257300Not currently.  It is planned.  See below.
    258301
    259 ==== Does Pidgin support microphones (voice)? ====
    260 ==== Does Pidgin support libjingle? ====
     302=== Does Pidgin support microphones (voice)? ===
     303=== Does Pidgin support libjingle? ===
    261304Not currently.  It is planned.  See below.
    262305
    263 ==== When will voice and video be implemented? ====
     306=== When will voice and video be implemented? ===
    264307We plan to implement these features eventually, but it is a daunting task.  Not all of our developers care about these features, and because of that don't want to work on them.  The time available to those developers who do want to work on these features is limited, and so any work on these features proceeds slowly.
    265308
     
    270313Some history and current status on voice and video should be collected at the ProgressReport page.
    271314
    272 === Miscellaneous ===
    273 
    274 ==== Can I change the height of the text input area? ====
    275 You can't manually resize the text input area, nor disable auto-resizing. The area auto-resizes up to a height of half the window height before the scrollbar appears.
    276 
    277 ==== How can I enter non-ASCII characters? (like Windows' Alt+###) ==== #win32-alt-codes
    278 Entering character codes works differently in GTK+; press `Ctrl+Shift+u` and then type the Unicode number (in hexadecimal) with Ctrl and Shift held down. GTK+ 2.10.0 and later versions do not require Ctrl and Shift to be held down while typing the number.  For example, `Alt-164` would become `Ctrl+Shift+u`, `f1`.
    279 
    280 ==== Can I still see messages in a chat if I close the window? ====
    281 Yes.  Pidgin has a persistent chat feature, where you will remain in a chat room even if you close the window.  When you open the window again, all the messages that were sent are still there as if the window had been open the whole time. 
    282 
    283 To make a chat persistent, add it to your buddy list, then right click and choose "Persistent" from the context menu.
    284 
    285 ==== How do I hide all those "User entered the room" and "User left the room" messages? ====
    286 
    287 Load the "Join/Part Hiding" plugin from the plugins dialog.  You can then configure it to hide these messages on rooms larger than a specified size, or when the user joining/parting has been idle for longer than a specified period of time.
    288 
    289 ==== What happened to my timestamps?  Can I change them? ====
    290 As of 2.0.0, timestamps follow the system locale.  This is a significant difference from previous versions of Pidgin, and though it was requested more than once, we know it will prove to be a controversial decision.  Fortunately for all of you out there, we also provide plugins to change it.
    291 
    292 The two plugins we provide are the Timestamp plugin and the Message Timestamp Formats plugin.  Timestamp allows you to have iChat style timestamps, but it is implemented to behave slightly differently.  The Message Timestamp Formats plugin allows you to manipulate the timestamps in a couple different ways, such as restoring 24-hour timestamps and/or causing all timestamps to have dates in them.
    293 
    294 ==== What is a "Buddy Pounce"? ====
    295 Pidgin introduced buddy pounces a few releases before AOL came out with "Buddy Alerts."  Despite this, you could think of a buddy pounce as an alert and get an idea of the most minimal use of a buddy pounce.  In reality, a buddy pounce is much like a macro, or a recorded action.  When you set a pounce on someone, you can choose from a number of events, such as sign on or status change, and then you choose from a number of actions.  These actions include everything from playing a sound (like an alert would do) to sending a message to the person, to executing a command.  This action will occur the next time pidgin detects the event, i.e. the next time the person in your buddy list who you have pounced signs on.
    296 
    297 ==== Can I use Pidgin for e-mail, blogging, RSS feeds, social networking, or anything else that isn't IM-related? ====
    298 No, you can't.  We get requests for this often, but Pidgin is indeed a messaging client.  Aside from the capabilities each protocol may support, the Pidgin developers have no intention to turn Pidgin into a multi-feature Internet client capable of doing everything under the sun.  We also won't be helping to develop plugins to turn it into that.  There are many Internet applications available for Linux, Windows, or whatever operating system you use that would undoubtedly do a better job.
    299 
    300 Note that [http://www.livejournal.com LiveJournal] provides an XMPP messaging service which makes it possible to make entries to your blog via IM, no matter what XMPP-supporting IM client you use.
    301 
    302 ==== Pidgin beeps whenever I press backspace, how do I disable that? ====
    303 
    304 See http://developer.pidgin.im/ticket/3683 .
    305 
    306 ==== Can I turn the tray icon off? ====
    307 Yes.  By default the tray icon will load if you have a Notification Area or a System Tray in your desktop environment.  Look at the Interface tab in Tools->Preferences.  Change the 'System Tray Icon' setting to 'Always', 'Never', or 'On unread messages' as you prefer.
    308 
    309 ==== What do those colors in the conversation tab mean? ====
    310  * '''Red''' - A message is waiting for you in a chat that does not contain your name
    311  * '''Blue''' - Someone (in one-on-one IM) sent you a message or (in chats) said your name/nickname
    312  * '''Green''' - The buddy is typing
    313  * '''Yellow''' - The buddy began typing, and then stopped
    314  * '''Gray''' - There has been a join or a part in that chat, or the buddy has signed off
    315 
    316 ==== I get "accept/reject certificate" prompts all the time. What do I do? ====
    317 This may mean that the Pidgin root certificate set is incomplete. If so, we'd like to hear about it. Do the following:
    318  1. Accept the Certificate
    319  2. Go to Tools->Certificates
    320  3. Select the relevant server and export the certificate to a file.
    321  4. [/simpleticket File a ticket]. Attach the exported certificate, and specify which protocol you are connecting to, as well as the server the certificate is for.
    322 
    323 ==== How do I join an existing chat room? ====
    324 '''Option 1: via invitation'''[[BR]]
    325 Ask someone who is in the chatroom to invite you. On MSN, this is the only way to join a chat room.
    326 
    327 '''Option 2: join yourself'''[[BR]]
    328 use ''Buddies > Join a chat room'' in the buddy list window
    329 
    330 ==== How do I create a chat room? ====
    331 
    332 '''IRC, XMPP/Jabber, ICQ, AIM'''[[BR]]
    333 Just join a non-existing chat room and it will be created.
    334 
    335 '''MSN'''[[BR]]
    336 Right-click an MSN buddy on your list and click "Initialize chat".
    337 
    338 '''SIP/SIMPLE'''[[BR]]
    339 This protocol doesn't support chat rooms.
    340 
    341 == Windows Specific ==
    342 
    343 === Proxy and Connection Settings and Problems ===
    344 
    345 ==== Why can't I connect? My firewall is configured to allow Pidgin access. ==== #windowsfirewall
     315== Proxy and Connection Settings and Problems (Windows) ==
     316
     317=== Why can't I connect? My firewall is configured to allow Pidgin access. === #windowsfirewall
    346318We've had a lot of problems with various firewalls, particularly Norton Internet Security (and Symantec Client Firewall).  Many firewalls will not fully stop interfering with a program's ability to connect when configured to do so.
    347319
     
    356328The Mozilla folks maintain a good Windows Firewall information resource [http://kb.mozillazine.org/Firewalls here].
    357329
    358 ==== What does "Windows socket error !#10060" mean, and how do I fix it? ====
     330=== What does "Windows socket error !#10060" mean, and how do I fix it? ===
    359331This is a horribly obtuse error message which simply means that Pidgin was unable to connect to some remote host, probably the IM server you were trying to use.  This is almost never a problem with Pidgin or its configuration; generally it indicates a network problem, firewall problem, or NAT/router problem.  If you are running a Windows firewall product, check [#windowsfirewall the appropriate FAQ question] for possible solutions.
    360332
    361 ==== Can Pidgin use my Windows (IE) Proxy Settings? ====
     333=== Can Pidgin use my Windows (IE) Proxy Settings? ===
    362334Yes, if you set the proxy preference to "Use Environmental Settings", Pidgin will parse the HTTP Proxy setting from Windows as long as you have a specific server set; auto-detection and configuration via `.pac` URL do not work, nor do proxy bypass settings.
    363335
    364 === Running Windows Pidgin From a USB Drive (Portable Mode) ===
     336== Proxy and Connection Settings and Problems (Linux and Unix-like platforms) ==
     337There are no known *nix-specific network issues.
     338
     339== Sound (Windows) ==
     340There are no known issues with sound on Windows.
     341
     342== Sound (Linux and Unix-like platforms) ==
     343
     344=== How do I get sound to work correctly? ===
     345Pidgin uses gstreamer to play sounds.  Playing sounds directly through esound or arts is no longer supported.  To compile Pidgin with support for gstreamer you need libgstreamer0.10-dev and its dependencies.  These packages are named differently on different platforms.  If you do not wish to install these packages you can also just change your sound playing method in preferences to `Command` and use `esdplay %s`, `artsplay %s`, `aplay %s`, or `play %s`.
     346
     347=== How do I make Pidgin use ALSA or OSS for playing sounds? ===
     348=== What does the "Automatic" option do? ===
     349The "Automatic" option lets gstreamer pick how the sounds are played.  You can use the `gstreamer-properties` tool to control this if you use GNOME.
     350
     351== Running Windows Pidgin From a USB Drive (Portable Mode) ==
    365352It is relatively easy to set up Pidgin to run from a USB drive. Most of Pidgin is very good about not assuming that it is installed; a slightly customized launcher makes it all come together nicely.
    366353
     
    415402In order to upgrade Pidgin portable to a new version, simply download the latest [http://sourceforge.net/project/showfiles.php?group_id=235&package_id=230234 zipped binaries] and follow the steps described in the '''Pidgin''' section above.
    416403
    417 === Smileys (Emoticons) ===
    418 
    419 ==== Why did my smiley theme disappear after I upgraded Pidgin? ====
    420 Smiley themes should be installed to the user's .purple directory, not in the location Pidgin is installed to.  This means that you install smiley themes only to `%APPDATA%\.purple\smileys`.  Additions to or removals from Pidgin's installation location will be lost during an upgrade.
    421 
    422 === Look & Feel ===
    423 
    424 ==== How do I change the look and feel? ====
    425 See [#CanIskinPidgin this FAQ entry].
    426 
    427 ==== What is a gtkrc file and where can I find it? ====
    428 The windowing toolkit that Pidgin uses, GTK+, is configurable via a text file.
    429 
    430 There is a global file found in the `etc\gtk-2.0` directory your GTK+ Runtime install directory (`C:\Program Files\Common Files\GTK\2.0`, by default).
    431 There is also per-user file (named `.gtkrc-2.0`) in your user's home directory, the location of this varies according to the version of Windows you're using and the configuration.
    432  * For Windows 2000/XP/Vista(?), entering `%USERPROFILE%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username`).
    433  * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`.
    434  * If you have the `HOME` environment variable set, it will override the default per-user file location.
    435 
    436 **Note that Windows Explorer will not allow you create a file that starts with a period; you'll need to use a text editor or rename the file in a cmd shell.
    437 
    438 There is also a pidgin-specific file that is located in the configuration directory (`%APPDATA%\.purple\gtkrc-2.0`).
    439 
    440 It is recommended that you edit your per-user file or the pidgin-specific file instead of the global file as the global file will be replaced when GTK+ is upgraded.
    441 
    442 ==== Can I make Pidgin transparent/translucent? ====
    443 You can make Pidgin translucent in most versions of Windows using the "Transparency" plugin that ships with Pidgin for Windows.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can to make any window translucent.
    444 
    445 ==== Can I make Pidgin or its instant message windows always stay on top? ====
    446 If you just want the buddy list to always be on top, you can dock it to the side of your desktop.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can set any window to be 'Always On Top'.
    447 
    448 === Miscellaneous ===
    449 
    450 ==== How does Pidgin for Windows determine which language to use? ====
     404== Running Linux Pidgin From a USB Drive (Portable Mode) ==
     405This should be possible somehow, but it's not tested and not documented.
     406
     407== Miscellaneous (All platforms) ==
     408
     409=== Can I change the height of the text input area? ===
     410You can't manually resize the text input area, nor disable auto-resizing. The area auto-resizes up to a height of half the window height before the scrollbar appears.
     411
     412=== How can I enter non-ASCII characters? (like Windows' Alt+###) === #win32-alt-codes
     413Entering character codes works differently in GTK+; press `Ctrl+Shift+u` and then type the Unicode number (in hexadecimal) with Ctrl and Shift held down. GTK+ 2.10.0 and later versions do not require Ctrl and Shift to be held down while typing the number.  For example, `Alt-164` would become `Ctrl+Shift+u`, `f1`.
     414
     415=== Can I still see messages in a chat if I close the window? ===
     416Yes.  Pidgin has a persistent chat feature, where you will remain in a chat room even if you close the window.  When you open the window again, all the messages that were sent are still there as if the window had been open the whole time. 
     417
     418To make a chat persistent, add it to your buddy list, then right click and choose "Persistent" from the context menu.
     419
     420=== How do I hide all those "User entered the room" and "User left the room" messages? ===
     421
     422Load the "Join/Part Hiding" plugin from the plugins dialog.  You can then configure it to hide these messages on rooms larger than a specified size, or when the user joining/parting has been idle for longer than a specified period of time.
     423
     424=== What happened to my timestamps?  Can I change them? ===
     425As of 2.0.0, timestamps follow the system locale.  This is a significant difference from previous versions of Pidgin, and though it was requested more than once, we know it will prove to be a controversial decision.  Fortunately for all of you out there, we also provide plugins to change it.
     426
     427The two plugins we provide are the Timestamp plugin and the Message Timestamp Formats plugin.  Timestamp allows you to have iChat style timestamps, but it is implemented to behave slightly differently.  The Message Timestamp Formats plugin allows you to manipulate the timestamps in a couple different ways, such as restoring 24-hour timestamps and/or causing all timestamps to have dates in them.
     428
     429=== What is a "Buddy Pounce"? ===
     430Pidgin introduced buddy pounces a few releases before AOL came out with "Buddy Alerts."  Despite this, you could think of a buddy pounce as an alert and get an idea of the most minimal use of a buddy pounce.  In reality, a buddy pounce is much like a macro, or a recorded action.  When you set a pounce on someone, you can choose from a number of events, such as sign on or status change, and then you choose from a number of actions.  These actions include everything from playing a sound (like an alert would do) to sending a message to the person, to executing a command.  This action will occur the next time pidgin detects the event, i.e. the next time the person in your buddy list who you have pounced signs on.
     431
     432=== Can I use Pidgin for e-mail, blogging, RSS feeds, social networking, or anything else that isn't IM-related? ===
     433No, you can't.  We get requests for this often, but Pidgin is indeed a messaging client.  Aside from the capabilities each protocol may support, the Pidgin developers have no intention to turn Pidgin into a multi-feature Internet client capable of doing everything under the sun.  We also won't be helping to develop plugins to turn it into that.  There are many Internet applications available for Linux, Windows, or whatever operating system you use that would undoubtedly do a better job.
     434
     435Note that [http://www.livejournal.com LiveJournal] provides an XMPP messaging service which makes it possible to make entries to your blog via IM, no matter what XMPP-supporting IM client you use.
     436
     437=== Pidgin beeps whenever I press backspace, how do I disable that? ===
     438
     439See http://developer.pidgin.im/ticket/3683 .
     440
     441=== Can I turn the tray icon off? ===
     442Yes.  By default the tray icon will load if you have a Notification Area or a System Tray in your desktop environment.  Look at the Interface tab in Tools->Preferences.  Change the 'System Tray Icon' setting to 'Always', 'Never', or 'On unread messages' as you prefer.
     443
     444=== What do those colors in the conversation tab mean? ===
     445 * '''Red''' - A message is waiting for you in a chat that does not contain your name
     446 * '''Blue''' - Someone (in one-on-one IM) sent you a message or (in chats) said your name/nickname
     447 * '''Green''' - The buddy is typing
     448 * '''Yellow''' - The buddy began typing, and then stopped
     449 * '''Gray''' - There has been a join or a part in that chat, or the buddy has signed off
     450
     451=== I get "accept/reject certificate" prompts all the time. What do I do? ===
     452This may mean that the Pidgin root certificate set is incomplete. If so, we'd like to hear about it. Do the following:
     453 1. Accept the Certificate
     454 2. Go to Tools->Certificates
     455 3. Select the relevant server and export the certificate to a file.
     456 4. [/simpleticket File a ticket]. Attach the exported certificate, and specify which protocol you are connecting to, as well as the server the certificate is for.
     457
     458=== How do I join an existing chat room? ===
     459'''Option 1: via invitation'''[[BR]]
     460Ask someone who is in the chatroom to invite you. On MSN, this is the only way to join a chat room.
     461
     462'''Option 2: join yourself'''[[BR]]
     463use ''Buddies > Join a chat room'' in the buddy list window
     464
     465=== How do I create a chat room? ===
     466
     467'''IRC, XMPP/Jabber, ICQ, AIM'''[[BR]]
     468Just join a non-existing chat room and it will be created.
     469
     470'''MSN'''[[BR]]
     471Right-click an MSN buddy on your list and click "Initialize chat".
     472
     473'''SIP/SIMPLE'''[[BR]]
     474This protocol doesn't support chat rooms.
     475
     476== Miscellaneous (Windows) ==
     477
     478=== How does Pidgin for Windows determine which language to use? ===
    451479For the user who installed Pidgin, the language selected during installation will be the default.
    452480This can be overridden by setting the `PIDGINLANG` environment variable (for example, `PIDGINLANG=de`).
     
    455483You can add the `PIDGINLANG` environment variable for your system in '''Start > Settings > Control Panel > System > Advanced > Environment Variables'''.
    456484
    457 ==== Where are my settings and data (including logs) saved? ====
    458 ==== Where is my `.purple` directory? ====
     485=== Where are my settings and data (including logs) saved? ===
     486=== Where is my `.purple` directory? ===
    459487Data is stored in your user's "Application Data" directory in a `.purple` subdirectory.  The location of this will vary according to your setup and version of Windows.
    460488 * For Windows 2000/XP/Vista(?), entering `%APPDATA%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username\Application Data`).
     
    466494Logs are stored in a subdirectory called `logs`.
    467495
    468 ==== How do I run multiple instances of Pidgin on Windows? ====
     496=== How do I run multiple instances of Pidgin on Windows? ===
    469497Pidgin will, by default, prevent multiple instances from running simultaneously.
    470498You can override this restriction by defining the `PIDGIN_MULTI_INST` environment variable or by specifying the `-m` command line parameter.
    471499If you do this, you may find the `-c` parameter useful to specify unique configuration directories for each instance (e.g. `-c c:\home\.pidgin-alt`).
    472500
    473 ==== Can I use Pidgin for Bonjour (Link-Local Messaging)? ====
     501=== Can I use Pidgin for Bonjour (Link-Local Messaging)? ===
    474502As of version 2.0.2, Pidgin for Windows supports Bonjour.  You must install Apple's [http://www.apple.com/support/downloads/bonjourforwindows.html Bonjour for Windows] to use this functionality.
    475503
    476 ==== Can I run Pidgin on Windows98/ME? ====
     504=== Can I run Pidgin on Windows98/ME? ===
    477505Yes, but you need to use an old GTK+ runtime (2.6.10 or older); you can download the [http://downloads.sourceforge.net/pidgin/gtk-runtime-2.6.10-rev-a.exe standalone GTK+ 2.6.10 runtime installer] and install it separately before installing Pidgin.  These old GTK+ versions are unmaintained and will have bugs that won't be fixed.
    478506
    479 ==== Why does searching in the Buddy List stop after the first character is typed? ==== #typeahead-win32
     507=== Why does searching in the Buddy List stop after the first character is typed? === #typeahead-win32
    480508See [bug:4966 Bug #4966] for information about this issue.
    481509
    482 == Linux and Unix-like platforms ==
    483 
    484 === Sound ===
    485 
    486 ==== How do I get sound to work correctly? ====
    487 Pidgin uses gstreamer to play sounds.  Playing sounds directly through esound or arts is no longer supported.  To compile Pidgin with support for gstreamer you need libgstreamer0.10-dev and its dependencies.  These packages are named differently on different platforms.  If you do not wish to install these packages you can also just change your sound playing method in preferences to `Command` and use `esdplay %s`, `artsplay %s`, `aplay %s`, or `play %s`.
    488 
    489 ==== How do I make Pidgin use ALSA or OSS for playing sounds? ====
    490 ==== What does the "Automatic" option do? ====
    491 The "Automatic" option lets gstreamer pick how the sounds are played.  You can use the `gstreamer-properties` tool to control this if you use GNOME.
    492 
    493 === Look & Feel ===
    494 
    495 ==== How do I change the look and feel? ====
    496 See [#CanIskinPidgin this FAQ entry].
    497 
    498 Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
    499 
    500 The system-wide location on Windows to add themes is `C:\Program Files\Common Files\GTK\2.0\share\themes`, but this location will be overwritten when installing updated GTK+ runtime versions.
    501 
    502 ==== Can I make Pidgin transparent/translucent? ====
    503 It is not yet possible to make Pidgin translucent in Linux and other platforms that use X11.
    504 
    505 The X.org X11 server provides a COMPOSITE extension that allows applications to have true translucency, but it is X.org-specific and it requires support at the GTK+ level (if it is to be per-widget).  Support for this is apparently scheduled for inclusion GDK 2.12, but we are not currently interested in implementing support for it (note that a plugin could provide this functionality).  Pseudo-translucency offered by other programs (by copying a section of your background image, tinting it, and plastering it onto a window) will never be implemented in Pidgin.
    506 
    507 Note that if you are using a compisiting window manager such as Compiz, you may have global support for modifying the opacity of any window.  For example, in Compiz, the default method to changing the opacity of a window is Alt+Mouse Scroll Wheel.  This method does not require extra support from the applications.
    508 
    509 === Miscellaneous ===
    510 
    511 ==== Where are Pidgin's settings and logs? ====
     510== Miscellaneous (Linux and Unix-like platforms) ==
     511
     512=== Where are Pidgin's settings and logs? ===
    512513Because Pidgin is a libpurple client, it stores its settings and logs in ~/.purple.
    513514
    514 ==== Why does Pidgin use the same `WM_CLASS` for every window? ====
     515=== Why does Pidgin use the same `WM_CLASS` for every window? ===
    515516Both strings in the `WM_CLASS` property are supposed to be the same for all windows in the same instance of an application.  ICCCM states that one is meant to be the same for all instances of the application and the other is meant to be unique to that instance of the application.  ICCCM also states, "If a client has multiple windows with identical `WM_CLASS` and `WM_NAME` properties, then it should provide a `WM_WINDOW_ROLE` property."
    516517
    517518GTK+ sets these `WM_CLASS` values for us so that they are unique for Pidgin instances, and the documentation for the `gtk_window_set_wmclass` function says explicitly not to use it for anything else.  Pidgin uses the `WM_WINDOW_ROLE` hint to differentiate windows.  If your window manager is having problems differentiating between Pidgin windows, please ensure it uses the `WM_WINDOW_ROLE` hint per the ICCCM.
    518519
    519 ==== Pidgin doesn't remember which plugins I have enabled between restarts ====
     520=== Pidgin doesn't remember which plugins I have enabled between restarts ===
    520521
    521522Ubuntu Gutsy shipped a broken `/etc/purple/prefs.xml` for a while which caused this problem.  See [https://bugs.launchpad.net/ubuntu/+source/pidgin/+bug/144122 this bug report] for information on the problem and how to fix it.
    522523
     524
All information, including names and email addresses, entered onto this website or sent to mailing lists affiliated with this website will be public. Do not post confidential information, especially passwords!